/* ========================================================================= */
/* ------------------------------------------------------------------------- */
/*!
  \file			mw_recentfiles.h
  \date			Sep 2011
  \author		TNick

  \brief		Contains the definition for recent files in MainWindow


  Copyright (c) 2011, Nicu Tofan
 All rights reserved.

 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions are met:
	* Redistributions of source code must retain the above copyright
	  notice, this list of conditions and the following disclaimer.
	* Redistributions in binary form must reproduce the above copyright
	  notice, this list of conditions and the following disclaimer in the
	  documentation and/or other materials provided with the distribution.
	* Neither the name of the copyright holder nor the
	  names of its contributors may be used to endorse or promote products
	  derived from this software without specific prior written permission.

 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER AND CONTRIBUTORS "AS IS" AND
 ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 DISCLAIMED. IN NO EVENT SHALL NICU TOFAN BE LIABLE FOR ANY
 DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
 (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
 LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
 ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

*/
/* ------------------------------------------------------------------------- */
/* ========================================================================= */
#ifndef __MAINWINDOW_RECENTFILES_INC__
#define __MAINWINDOW_RECENTFILES_INC__
//
//
//
//
/*  INCLUDES    ------------------------------------------------------------ */


namespace Ui {
class MainWindow;
}

#include	<main.h>

#include	<QObject>
#include	<QAction>



/*  INCLUDES    ============================================================ */
//
//
//
//
/*  CLASS    --------------------------------------------------------------- */

/// List of recent files provided by a logical unit
/**
*	Basically, it
*	is able to load a previously saved list of files and to show it
*	in designated menu during the MW_RecentFiles::initRecentFiles() call.
*
*	Later, files may be added to the list with
*	MW_RecentFiles::addRecentFile(). As the initialization function binds
*	an internal slot to the menu items representing a recent file,
*	the unit will call MainWindow::_open() whenever the user decides to
*	open one.
*/
class	MW_RecentFiles : public QObject		{
	Q_OBJECT

	friend class MainWindow;

	friend class MW_BasicMdi;
	friend class MW_BasicSlots;
	friend class MW_SheetSlots;
	friend class MW_StyleSheets;
	friend class MW_UiTempl;

	//
	//
	//
	//
	/*  DATA         ------------------------------------------------------- */

private:

	/// recent files list
	QList<QString>          rcnt_f;

	/// number of recent files to store
	int                     rcnt_f_count;

	/*  DATA         ======================================================= */
	//
	//
	//
	//
	/*  FUNCTIONS    ------------------------------------------------------- */

public:

	MW_RecentFiles		() ;
	~MW_RecentFiles	() ;


protected:

	/// make first steps to make this work
	void	initRecentFiles			(Ui::MainWindow * lc_ui);

	/// places provided file to the top of recent files list
	void    addRecentFile           (QString s_file);


private slots:

	/// used to open a recent file from the menu
	void    slot_RecentFile         (QAction* p_active);

	/// recreates the list of recent files in the menu
	void    slot_UpdateRcFilesMenu  ( void );

	/*  FUNCTIONS    ======================================================= */
	//
	//
	//
	//
	/*  FUNCTIONS    ------------------------------------------------------- */


	/*  FUNCTIONS    ======================================================= */
	//
	//
	//
	//

};	/* class	MW_RecentFiles */

/*  CLASS    =============================================================== */
//
//
//
//
#endif // __MAINWINDOW_RECENTFILES_INC__
/* ------------------------------------------------------------------------- */
/* ========================================================================= */
